.biz


padbizLib
bizLib was written to overcome the limited user interface of PocketC. bizLib is a Native Library that is written in CodeWarrior and is a programmer friendly wrapper around the Palm OS 3.0+ operating System

By using a combination of PocketC and bizLib the developer has available a very powerful set of tools for creating business level applications.


The features of bizLib are
  • Forms / Dialogs
  • Dynamic User Interface Objects
  • InfraRed Printing without 3rd Party Products
  • Serial Printing
  • Date Functions
  • System Functions
  • Widgets
  • Application Functions
  • Small Footprint only 20K
  • Embeddable into PocketC applications

Function List by Category


Library
zVersion();
zEndLib();
zLibReg(int TextArray);


Forms
zNewForm(string Title);
zShowForm();
zDialog(int Height, string Title);
zDialogEnd();
zEvent(int dummy);
zSetFont(int FontID);
zFormInfo(int FrmFunc);


CheckBox
zCheckBox(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zStartGrp();
zEndGrp();
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Selector
zSelector(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Buttons
zButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Push Buttons
zPButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zStartGrp();
zEndGrp();
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Repeater Button
zRButton(int x, int y, int width, int height, string Caption);
zBtnStyle(int BoxStyle, int RightAlign);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Lists
zList(int x, int y, int width, int lines, int 0);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


DropDown Lists
zPopTrig(int x, int y, int width, int height, string Caption);
zList(int x, int y, int width, int lines, int triggerID);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


PopUp Lists
zList(int x, int y, int width, int lines, int 100);
zPopList(int resourceID);
zAddArray(int resourceID ,int TextArray, int ItemCnt);
zAddItem(int resourceID, string ListItem);
zFinList(int resourceID, int SortOrder);
zClearList(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zGetValue(int resourceID);
zSetValue(int resourceID, int Value);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);


Fields
zEdit(int x, int y, int width, int Lines, int MaxChars, string Text);
zEditStyle(int editable, int underline, int align, int ValidChars);
zAddrLookup(int resourceID);
zGetText(int resourceID);
zSetText(int resourceID, string Text);
zVisible(int resourceID, int State);
zIsVisible(int resourceID);
zCut();
zCopy();
zPaste();


Labels
zLabel(int x, int y, string Caption);
zCLabel(int x, int y, string Caption);
zRLabel(int x, int y, string Caption);


Widgets
zProgBar(int value);
zWaitBox(int state);


Date
zSelDate(int yyyymmdd, string Title);
zDateInfo(int DateValue, int FmtFunc);


System
zAutoOff(int delay);
zBackLight(int State);
zSysInfo(int InfoPtr);


Printing
zIrPrint(int TextArray, int ItemCnt);
zSerPrint(int TextArray, int ItemCnt);


Other
zGetPref(string CreatorID, int Item);
zSetPref(string CreatorID, int Item, string Settings);


Function Reference


zAddArray(int resourceID ,int TextArray, int ItemCnt);

Parameters

int resourceID

ID of a List Object returned from a zList function call

int TextArray

Name of a populated PocketC string array

int ItemCnt

Count of the number of items that you wish to copy to the list box

Purpose

To append the contents of a populated PocketC string array to the end of a Form List Object

Returns

Nothing

Comments


zAddItem(int resourceID, string ListItem);

Parameters

int resourceID

ID of a List Object returned from a zList function call

string ListItem

Name of a PocketC string

Purpose

To append the contents of a PocketC string to the end of a Form List Object

Returns

Nothing

Comments


zAddrLookup(int resourceID);

Parameters

int resourceID

an Id returned from a zEdit function call

Purpose

Call the Address Book Application to look up a phone number
When trying to match a field, this function first tries to match
selected text

If there is some selected text, the function replaces it with the phone number if there is a match. If there is no selected text, the function replaces the text in which the insertion point is with the phone number if there is a match. If there is no match, the function displays the Address Book short list.

Returns

Nothing

Comments


zAutoOff(int delay);

Parameters

int delay

number of seconds to delay until auto timer turns the Palm Device off

Purpose

Set the time out value in seconds for auto-power-off. (0) zero means never power off

Returns

Previous setting of the Auto Off Timer

Comments


zBackLight(int State);

Parameters

int state

0 turns the backlight off
1 turns the backlight on

Purpose

Turns the backlight on or off

Returns

Nothing

Comments


zBtnStyle(int BoxStyle, int LeftAnchor);

Parameters

int BoxStyle

0 no Button Frame
1 standard Button Frame
2 bold Button Frame
3 rectangleButtonFrame

Affects Buttons & Repeater Buttons

int LeftAnchor

true Locks the control's left co-ordinates
false Locks the controls right Coordinates

Affects Selector, Checkbox & Popup trigger.

Purpose

To alter the default display settings of buttons
All further calls to
zButton, zSelector & zRButton will use the new attributes until reset or a zNewForm function call is performed

Returns

Nothing

Comments


zButton(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of Button in pixels, 1 - 160, from left to right

int y

Position of Button in pixels 1 - 160, from top to bottom

int width

Width of Button in pixels, if 0 (zero) then the bizLib determines width of Button based upon Caption string

int height

Height of Button in pixels, if 0 (zero) then the bizLib determines height of Button based upon current Form font, see zSetFont

string Caption

Caption of Button, this is the initial text, it may be altered later with zSetText

Purpose

Place a Button Control onto the current Form

Returns

The resourceID of the newly created Button, this will be needed for use with function calls and event processing

Comments


zCheckBox(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of CheckBox in pixels, 1 - 160, from left to right

int y

Position of CheckBox in pixels 1 - 160, from top to bottom

int width

Width of CheckBox in pixels, if 0 (zero) then the bizLib determines width of CheckBox based upon Caption string

int height

Height of CheckBox in pixels, if 0 (zero) then the bizLib determines height of CheckBox based upon current Form font, see zSetFont

string Caption

Caption of Checkbox, this is the initial text, it may be altered later with zSetText

Purpose

Place a CheckBox Control onto the current Form

Returns

The resourceID of the newly created Checkbox, this will be needed for use with function calls and event processing

Comments


zClearList(int resourceID);

Parameters

int resourceID

the resource id returned from a zList function call

Purpose

Clears the contents of a Form ListBox, and releases the memory allocated to the ListBox contents

Returns

Nothing

Comments


zCopy();

Parameters

None

Purpose

Copies the selected text in an EditField control into the clipboard

Returns

Nothing

Comments


zCut();

Parameters

None

Purpose

Places the selected text in an EditField control into the clipboard and then erases the selected text from the EditField

Returns

Nothing

Comments


zDateInfo(int DateValue, int FmtFunc);

Parameters

int DateValue

Date in YYYYMMDD format or days since 1904

int FmtFunc

Function number to request date type, each function return information in various formats.

Func Returns Details
0 integer YYYYMMDD
1 string Short Date Format as specified in Prefs / Formats
2 string Long Date Format as specified in Prefs / Formats
3 string Short Day of Week - Sun, Mon, Tue .....
4 string Long Day of Week - Sunday, Monday, Tuesday ....
5 string Short Months - Jan, Feb, Mar, .....
6 string Long Months - January, February, March ....
7 integer Year in YYYY
8 integer Month in MM
9 integer Day in DD
10 integer Day of Week, 0 = Sunday, 1 = Monday ..
11 integer Days in the Month
12 integer Day of Month, ie. 3rd Tuesday in month ...
13 integer Days since 1st Jan 1904

Purpose

Return information about a given date in various formats

Returns

Refer above for format types
Returns -1 if an incorrect format is passed
With this function it is possible to calculate days between dates, add days to dates and most other date calculations.

Comments


zDialog(int Height, string Title);
zDialogEnd();

Parameters

int Height

Height of the Dialog Window in pixels, the window will be positioned at the bottom of the screen

string Title

Text to be displayed in the top middle of the window in inverse text

Purpose

Creates a dialog window so that the main form is not altered of affected by the new form activity.
There can only be 1 (one) dialog form, there is no error trapping for this in the Library so careful attention to the PocketC program is required
Any type of control may be placed onto the Dialog Form
Use
zEvent to interact with the Form

Returns

nothing

Comments


zEdit(int x, int y, int width, int Lines, int MaxChars, string Text);

Parameters

int x

Position of EditField in pixels, 1 - 160, from left to right

int y

Position of EditField in pixels 1 - 160, from top to bottom

int width

Width of EditField in pixels.

int height

height of EditField in lines of text, bizLib determines height of EditField based upon current Form font, see zSetFont if height equals 1 (one) the EditField is a single line edit if height is greater than 1 then the EditField will be drawn with scroll arrows at the right of the EditField and the user may enter information including newlines, newlines are counted as a character within the MaxChars limit

int MaxChars

The maximum number of characters that a user may enter into the EditField, including newlines

string Text

The initial text that will appear in the EditField ready for editing.

Purpose

Places an EditField onto a Form Allows the user to enter and edit textual information The standard graffiti shift indicator and autoshift rules apply keyboard popups work when cursor is within an EditField zCut, zCopy & zPaste all work with EditFields

Returns

Nothing

Comments


zEditStyle(int editable, int underline, int align, int ValidChars);

Parameters

int editable

true allows the user to edit the text in the EditField
false displays the EditField iin ReadOnly mode

int underline

true displays the EditField with a dotted underline as per PalmOS standard
false display no underline

int align

true Left Aligns the text in the EditField
false right Aligns the text in the EditField

int ValidChars

true allows any enterable character to be used
false allows only number and the decimal point to be entered

Purpose

To alter the display style of the EditField
All further calls to
zEdit will use the new attributes until reset or a zNewForm function call is performed

Returns

nothing

Comments


zEndGrp();

Parameters

None

Purpose

End the grouping of Push Buttons and Checkboxes

Returns

Nothing

Comments


zEndLib();

Parameters

None

Purpose

Must be called when finished using the Form Functions of the bizLib library
Releases all memory allocated to the Form objects
Restores PocketC back to normal configuration

Returns

Nothing

Comments


zEvent(int dummy);

Parameters

int dummy

Reserved for future use
Currently the only option available is 1 (one) i.e. Indefinite wait

Purpose

Allows interaction with the Form
When a
zEvent function is called the process will wait indefinitely for user input into the Form. The zEvent function returns whenever any of the following is selected:

Any Button Type
A Popup Trigger
A CheckBox
A Selector
An item in a ListBox
The Silk Screen Menu
The Title Bar

Returns

The resourceID of the selected item
The value 9999 is returned when the Title Bar or the Silk Screen Menu is selected

Comments


zFinList(int resourceID, int SortOrder);

Parameters

int resourceID

a resourceID returned from a zList function call

int SortOrder

Sorts the content of the ListBox

0 Do not Sort
1 Sort in Ascending Order
2 Sort in Descending Order

Purpose

Finalizes the contents of a Forms ListBox and redraws it on the Form if the ListBox is already visible
this function must be called once the programmer has finished with
zAddArray and zAddItem function calls to populate the Form ListBox
this function may be called any number of times if the programmer wishes to keep appending to the ListBox at a later stage
this function may be called any number of times if the programmer wishes to change the sort order displayed in the ListBox

Returns

Nothing

Comments


zFormInfo(int FormFunc);

Parameters

int FormFunc

0 FontID
1 Button Frame style
2 Button Alignment style
3 EditField Editable style
4 EditField Underline style
5 EditField Alignment style
6 EditField ValidChars style

Purpose

Returns information on the current style as set by zNewForm, zEditStyle, zBtnStyle and zSetFont

Returns

See Parameters

Comments


zGetPref(string CreatorID, int Item);

Parameters

string CreatorID

A Palm Creator ID, this must be registered with Palm and must be unique to your application

Int Item

Item number of the application preference

Purpose

To retrieve the application preferences from the Saved Preferences system
See
zSetPref for further details

Returns

Application preference

Comments


zGetText(int resourceID);

Parameters

int resourceID

a resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEdit
 

Purpose

Retrieves the text allocated to the nominated resource.

Returns

Buttons will return the current Caption text
EditFields will return the contents of the EditField
Popup Triggers will return the current Caption text
ListBoxes will return the currently select Item Text
Selectors will return the current Caption text
CheckBoxes will return the current Caption text

Comments


zGetValue(int resourceID);

Parameters

int resourceID

a resourceID returned from a call to one of the following Functions
zPButton
zList
zCheckBox
 

Purpose

Retrieves the current value of the nominated resource.

Returns

Push Buttons will return the current state - selected (1) or deselected (0)
ListBoxes will return the currently select Item - the first item is 0 (zero)
CheckBoxes will return the current state - checked (1) or unchecked (0)

Comments


zIrPrint(int TextArray, int ItemCnt);

Parameters

int TextArray

A PocketC String Array

int ItemCnt

The number of array items to print

Purpose

Prints the contents of a PocketC String Array to a Infrared Printer

Returns

0 Successful
-1 User cancelled the operation
-2 Timeout Occurred, currently this is 30 Seconds per operation

Comments


zIsVisible(int resourceID);

Parameters

int resourceID

A resource Id returned from creating any new Form Object, e.g. zButton

Purpose

Returns information on whether a control is visible or not

Returns

0 is NOT visible
-1 is currently visible

Comments


zLabel(int x, int y, string Caption);
zCLabel(int x, int y, string Caption);
zRLabel(int x, int y, string Caption);

Parameters

int x

Position of Label in pixels, 1 - 160, from left to right

int y

Position of Label in pixels 1 - 160, from top to bottom

string Caption

Caption of Label, this is the only way to set the text, it may NOT be altered later

Purpose

to place text labels onto the Form

Returns

Nothing

Comments

The values of x and y have different meaning depending on whick label function you choose.

zLabel - x & y are the coordinates of the top left of the label
zCLabel - x & y are the coordinates of the center top of the label
zRLabel - x & y are the coordinates of the top right of the label

These functions make it easy to place labels on the Form with left, centered or right alignment.


zLibReg(int TextArray);

Parameters

int TextArray

A PocketC string array of 9 elements containing the About Popup Form information for your application

Purpose

To fill the about box with information about your application. This about box is shown when the user selects the  © in the bottom right of the form.

 

Returns

0 registration successful
-1 registration failed

Comments

  string aReg[9];
    
  aReg[0] = "zEditStyle Program";
  aReg[1] = "";
  aReg[2] = "Author: Stewart Whiteside";
  aReg[3] = "CopyRight: Me";
  aReg[4] = "";
  aReg[5] = "http://myWebSite.com";
  aReg[6] = "";
  aReg[7] = "";
  aReg[8] = "";
    
  zLibReg(aReg);
   


   

zList(int x, int y, int width, int lines, int triggerID);

Parameters

int x

Position of ListBox in pixels, 1 - 160, from left to right

int y

Position of ListBox in pixels 1 - 160, from top to bottom

int width

Width of ListBox in pixels.

int height

Height of ListBox in lines of text, bizLib determines height of ListBox based upon current Form font, see zSetFont
if the number of items in the ListBox exceeds this value then scroll arrows will be drawn at the right of the ListBox and the user may scroll up or down the Listbox to select the desired information

int triggerID

0 Places the ListBox on the current Form and is visible when the Form is displayed
100 Places the ListBox on the current Form and only becomes visible with the zPopList function call
then the ListBox only remains visible until the users next interface event
ie. If the user selects an item from the ListBox or taps the screen somewhere outside the ListBox.
PopTrigID A resource ID returned from a zPopTrig function call, this creates a DropDownListBox style control.
Places the ListBox on the current Form and only becomes visible when the
user selects the nominated Popup Trigger control

Purpose

to place various forms of ListBoxes controls on the Form

Returns

nothing

Comments


zNewForm(string Title);

Parameters

string Title

Title of new Form, This string will display in inverse text at the top left of the new Form.

Purpose

Create a new Form on which to place controls, Edit Fields, Lists etc.
This Form is independent of the PocketC Graphics Forms and the Output Form, ie. All these forms can be used independently.
The
zNewForm function performs the following tasks.

Deletes any previous Form created with zNewForm and releases all allocated memory. Set the Font to StandardFont Resets all Lists Sets the Field Attributes to Editable, Underline, LeftAlign & AlphaNumeric character input, see zEditStyle Sets the Button Attributes to StandardBorder and Left Anchor, see zBtnStyle Creates the new Form with the title passed to it when invoked

Returns

Nothing

Comments


zPaste();

Parameters

None

Purpose

Pastes the text in the clipboard into the selection point of an EditField

Returns

Nothing

Comments


zPButton(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of PushButton in pixels, 1 - 160, from left to right

int y

Position of PushButton in pixels 1 - 160, from top to bottom

int width

Width of PushButton in pixels, if 0 (zero) then the bizLib determines width of PushButton based upon Caption string

int height

Height of PushButton in pixels, if 0 (zero) then the bizLib determines height of PushButton based upon current Form font, see zSetFont

string Caption

Caption of PushButton, this is the initial text, it may be altered later with zSetText

Purpose

Place a PushButton Control onto the current Form

Returns

The resourceID of the newly created PushButton, this will be needed for use with function calls and event processing

Comments


zPopList(int resourceID);

Parameters

int resourceID

a resourceID returned from a zList function call

Purpose

To display a ListBox object that was created with the zList function call with a triggerID of 100

Returns

0 thru to ItemCount - 1
The user selected item value from the displayed list 0 (zero) is the first item in the ListBox
-1 is returned if no item selected

Comments


zPopTrig(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of PopupTrigger in pixels, 1 - 160, from left to right

int y

Position of PopupTrigger in pixels 1 - 160, from top to bottom

int width

Width of PopupTrigger in pixels, if 0 (zero) then the bizLib determines width of PopupTrigger based upon Caption string

int height

Height of PopupTrigger in pixels, if 0 (zero) then the bizLib determines height of PopupTrigger based upon current Form font, see zSetFont

string Caption

Caption of PopupTrigger, this is the initial text, it may be altered later with zSetText

Purpose

Place a PopupTrigger Control onto the current Form

Returns

The resourceID of the newly created PopupTrigger, this will be needed for use with function calls and event processing

Comments


zProgBar(int value);

Parameters

int Value

The value of progress bar to display between -1 and 100
-1 turns the progress bar window off
1 thru 100 displays the progress bar with a pattern bar to indicate progress made

Purpose

To display a progress bar window that informs the user that some action is being performed by the program that may take some time, gives the user some positive feedback that the program has not unexpectedly stopped.

Returns

Nothing

Comments


zRButton(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of RepeatButton in pixels, 1 - 160, from left to right

int y

Position of RepeatButton in pixels 1 - 160, from top to bottom

int width

Width of RepeatButton in pixels, if 0 (zero) then the bizLib determines width of RepeatButton based upon Caption string

int height

Height of RepeatButton in pixels, if 0 (zero) then the bizLib determines height of RepeatButton based upon current Form font, see zSetFont

string Caption

Caption of RepeatButton, this is the initial text, it may be altered later with zSetText

Purpose

Place a RepeatButton Control onto the current Form

Returns

The resourceID of the newly created RepeatButton, this will be needed for use with function calls and event processing

Comments


zSelDate(int yyyymmdd, string Title);

Parameters

int yyyymmdd

A numeric date in YYYYMMDD format, this will be the starting date when the Date Selection Window pops up

string Title

A PocketC string that will appear in the Title Bar of the Date Selection Window

Purpose

To enable easy selection of dates

Returns

The selected date in YYYYMMDD format
-1 if the user cancels the selection

Comments


zSelector(int x, int y, int width, int height, string Caption);

Parameters

int x

Position of Selector in pixels, 1 - 160, from left to right

int y

Position of Selector in pixels 1 - 160, from top to bottom

int width

Width of Selector in pixels, if 0 (zero) then the bizLib determines width of Selector based upon Caption string

int height

Height of Selector in pixels, if 0 (zero) then the bizLib determines height of Selector based upon current Form font, see zSetFont

string Caption

Caption of Selector, this is the initial text, it may be altered later with zSetText

Purpose

Place a Selector Control onto the current Form

Returns

The resourceID of the newly created Selector, this will be needed for use with function calls and event processing

Comments


zSerPrint(int TextArray, int ItemCnt);

Parameters

int TextArray

a PocketC String Array

int ItemCount

the number of array items to print

Purpose

Prints the contents of a PocketC String Array to a Serial Device

Returns

0 Successful
-1 User cancelled the operation
-2 Timeout Occurred, determined by seropen settings

Comments

This function must be used in conjunction with the PocketC functions
seropen and serclose

First, open the serial port with the desired parameters
Second, issue the
zSerPrint function with the populated array
Third, close the serial port


zSetPref(string CreatorID, int Item, string Settings);

string CreatorID

A Palm Creator ID, this must be registered with Palm and must be unique to your application

Int Item

Item number of the application preference

Purpose

To retrieve the application preferences from the Saved Preferences system

Returns

Application preference

Comments


zSetFont(int FontID);

Parameters

int FontID

the selected FontID for the next operation, affects all controls

0 stdFont
1 boldFont
2 largeFont
7 largeBoldFont
3 symbolFont
4 symbol11Font
5 symbol7Font
6 ledFont

Purpose

To select a nominated font for all subsequent new controls
The font is reset back to stdFont with the next
zNewForm function call

Returns

Nothing

Comments


zSetText(int resourceID, string Text);

Parameters

int resourceID

a resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEdit

string Text

The new text string to set the control with

Purpose

Sets the text allocated to the nominated resource.

Returns

Nothing

Comments


zSetValue(int resourceID, int Value);

Parameters

int resourceID

A resourceID returned from a call to one of the following Functions
zPButton
zList
zCheckBox

int Value

The value with which to set the nominated control
0 or 1 for PushButtons, 1 sets the PushButton, 0 clears it
0 or 1 for CheckBoxs, 1 checks the checkbox, 0 unchecks it

listBoxes - the value will select that item in the Listbox, 0 is the first item, if the ListBox is displayed then the item will become visible in the ListBox and will be indicated selected.

Purpose

Sets the current value of the nominated resource.

Returns

Nothing 

Comments


zShowForm();

Parameters

None

Purpose

To display the current form or dialog, ready for user interaction
After a
zShowForm call is issued then no further object may be created for that form

Returns

Nothing

Comments


zStartGrp();

Parameters

None

Purpose

Start the grouping of Push Buttons and CheckBoxs.

Returns

Nothing

Comments

each group allows the controls to automatically react with other controls in the the same group, this allows multiple groups of PushButtons and CheckBoxs to be placed on the same form.


zSysInfo(int funct);

Parameters

int funct

0 Operating System Version String
1 ROM Version
2 Product ID
3 remaining battery Volts
4 Type of Battery
5 is device plugged in plugged
6 Percentage of Battery remaining
7 Auto Off Timer Seconds
8 System Ticks Per Second

Purpose

Returns the requested information about the system

Returns

Function Type Info example
0 string Operating System Version String "v.3.0."
1 string ROM Version
0xMMmfsbbb,
where
MM
is major version
m
is minor version
f
is bug fix
s
is stage: 3-release,2-beta,1-alpha,0-development
bbb
is build number for non-releases
"01122003"
2 string Product ID
0xMMMMRRRR, where MMMM is the model and
RRRR
is the revision.
"00000000"
3 int Battery Volts - current voltage * 100 250 = 2.5volts
4 int Type of Battery 0=Alkaline, 1=NiCad, 2=Lithium 1
5 int is device plugged in plugged 0=No, 1=Yes 0
6 int Percentage of Battery remaining 50 = 50%
7 int Auto Off Timer Secs 0=never turn off 0
8 int System Ticks Per Second 10

Comments


zVersion();

Parameters

None

Purpose

Retrieve the version number of the current bizLib

Returns

The version number in an integer format
10000 = Mmmbb where M=Major, mm=minor and bb=bugfixes

Comments

Current version is 1.00.00


zVisible(int resourceID, int State);

Parameters

int resourceID

A resourceID returned from a call to one of the following Functions
zButton
zPButton
zRButton
zPopTrig
zList
zSelector
zCheckBox
zEdit

int State

The new state with which you want to set the control
0 - hide the control
1 - show the control

Purpose

To hide and show controls on a Form

Returns

Comments

Only works if the form is showing use zShowForm();


zWaitBox(int state);

Parameters

int state

0 - hide the WaitBox window
1 - show the WaitBox window

Purpose

Shows or hides a Wait Window

Returns

Nothing

Comments

Gives the user positive feedback that the delay is programmed for